Skip to content

feat(changelog): draft each release entry with Claude - #179

Merged
Alexays merged 4 commits into
feat/changelog-playbackfrom
feat/changelog-drafts
Nov 6, 2026
Merged

Alexays merged 4 commits into
feat/changelog-playbackfrom
feat/changelog-drafts

Conversation

@maximebrmd

@maximebrmd maximebrmd commented Nov 6, 2026 •

Copy link
Copy Markdown
Collaborator

Why

The changelog entries were hand-written, and a feature release could not be cut without them. Replaces the regex selection from #154 and the release gating from #156.

What changed

  • make changelog-draft turns notes and commits into the website story, What's New highlights and copy in all 15 locales. It uses Claude Opus 5.5 with structured output and server-side refusal fallbacks.
  • Claude refers to notes by number, so a story quotes them exactly. The tool refuses a draft that drops or repeats a note, and retries once with the reason.
  • Pushing a tag opens a draft pull request with any missing entry. Merging it is the approval.
  • An entry never blocks a release: make release-version warns instead of refusing, and the website holds a drafted entry back until its release is published.
  • /changelog/<version>/ pages, RSS in English and French built with @astrojs/rss and carrying each release's full notes, a social image per release, and the remaining notes grouped by area as Linear does.

Before it can run

  • Add an ANTHROPIC_API_KEY repository secret. Without it the workflow skips with a notice.
  • Enable Allow GitHub Actions to create and approve pull requests.

Verification

  • make release-media-test, release-test, site-check, site-test, and the changelog browser tests pass.
  • The prompt ran on the real 0.16.0 notes through claude -p with the same model: all 52 notes placed, no invented claims, about $0.90.
  • The API path has not run against the live API, because no key is available here. The SDK call was exercised against a fake server, which confirmed the request shape and parsing. The translation call and the workflow have not run at all.

Review after the playback PR. It targets that branch to keep the diff focused.

@maximebrmd
maximebrmd requested a review from Alexays as a code owner November 6, 2026 12:58
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Nov 6, 2026 •

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Failed ❌

View logs ↗
ac3a2ae 2026-11-06T14:42:19.443Z View logs ↗
  • Build: Failed ❌

View logs ↗
5011432 2026-11-06T13:58:46.232Z View logs ↗
  • Build: Failed ❌

View logs ↗
a2acadb 2026-11-06T12:56:11.391Z View logs ↗

make changelog-draft turns a release's notes into the website story, What's New
highlights and copy in every language. Claude refers to notes by number, so an
entry quotes them exactly, and the tool refuses a draft that leaves one out.
Pushing a tag opens a draft pull request with any missing entry.

An entry no longer holds a release back: make release-version warns, and the
website keeps a drafted entry out of sight until its release is published.

The changelog gains a page per release, RSS feeds, a social image per release
and the remaining notes grouped by product area.
The official helper owns the escaping, dates and absolute links, and carries
each release's complete notes, so a feed reader shows the whole entry.
A drafted highlight can carry a plan: steps that drive the compiled app, and a
template that turns the shots into a silent 1080p loop or a sharp still with
HyperFrames and GSAP. One data-driven test replaces per-feature capture code,
and close-ups need no screen recording permission.

make changelog-media runs a release's plans. A plan that fails leaves its
highlight text-only and says why, and the Changelog draft workflow adds what it
films to the pull request. The 0.16.0 stacks highlight is its first film.
@maximebrmd
maximebrmd force-pushed the feat/changelog-playback branch from 4dd8650 to 1e60ed4 Compare November 6, 2026 14:41
@maximebrmd
maximebrmd force-pushed the feat/changelog-drafts branch from 5011432 to ac3a2ae Compare November 6, 2026 14:41
feat(changelog): film release highlights from the real app
@Alexays
Alexays merged commit 5b1382a into feat/changelog-playback Nov 6, 2026
@Alexays
Alexays deleted the feat/changelog-drafts branch November 6, 2026 21:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants